package com.shisan.tingshu.album.client;

import com.shisan.tingshu.album.client.impl.AlbumInfoDegradeFeignClient;
import com.shisan.tingshu.common.result.Result;
import com.shisan.tingshu.model.album.AlbumInfo;
import com.shisan.tingshu.model.album.BaseCategory3;
import com.shisan.tingshu.model.album.BaseCategoryView;
import com.shisan.tingshu.model.album.TrackInfo;
import com.shisan.tingshu.vo.album.AlbumStatVo;
import com.shisan.tingshu.vo.album.TrackListVo;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;

import java.util.List;

/**
 * <p>
 * 产品列表API接口
 * </p>
 */
@FeignClient(value = "service-album", fallback = AlbumInfoDegradeFeignClient.class, path = "/rpc/inner/albuminfo")
public interface AlbumInfoFeignClient { // 是一个 Feign 客户端接口，用于定义远程调用的方法签名

    /**
     * 获取专辑详情
     * @param albumId
     * @return
     */
    // 这是一个 Spring MVC 的注解，用于将 HTTP GET 请求映射到指定的路径
    // 在这里，它表示当调用 `getAlbumInfoAndAttrvalue` 方法时，会向 `/getAlbumInfoAndAttrvalue/{albumId}` 路径发送一个 GET 请求
    @GetMapping("/getAlbumInfoAndAttrValue/{albumId}")
    // 这是一个方法声明，它定义了一个远程调用的方法
    // `@PathVariable` 注解用于将 URL 中的参数 `albumId` 绑定到方法的参数 `albumId` 上
    // 该方法的返回类型是 `Result<AlbumInfo>`，表示远程调用的结果是一个包含 `AlbumInfo` 对象的 `Result` 对象
    Result<AlbumInfo> getAlbumInfoAndAttrValue(@PathVariable(value = "albumId") Long albumId);

    /**
     * 获取专辑分类
     * @param albumId
     * @return
     */
    @GetMapping("/getAlbumCategory/{albumId}")
    Result<BaseCategoryView> getAlbumCategory(@PathVariable(value = "albumId") Long albumId);

    /**
     * 获取专辑统计信息
     * @param albumId
     * @return
     */
    @GetMapping("/getAlbumStat/{albumId}")
    Result<AlbumStatVo> getAlbumStat(@PathVariable(value = "albumId") Long albumId);

    /**
     * 根据一级分类id查询该一级分类下的置顶的三级分类集合
     * @param c1Id
     * @return
     */
    @GetMapping("/getBaseCategory3ListByC1Id/{albumId}")
    Result<List<BaseCategory3>> getBaseCategory3ListByC1Id(@PathVariable(value = "albumId") Long c1Id);

    /**
     * 查询全平台的一级分类id
     * @return
     */
    @GetMapping("/getAllCategory1Id")
    Result<List<Long>> getAllCategory1Id();

    /**
     * 根据声音id集合，查询声音对象集合
     * @param trackIdList
     * @return
     */
    @PostMapping("/getTrackListByIds")
    Result<List<TrackListVo>> getTrackListByIds(List<Long> trackIdList);

    /**
     * 查询所有的专辑id集合
     * @return
     */
    @GetMapping("/getAlbumInfoIdList")
    Result<List<Long>> getAlbumInfoIdList();

    /**
     * 查询指定集数的声音列表
     * @param userId
     * @param trackId
     * @param trackCount
     * @return
     */
    @GetMapping("/getTrackListByCurrentTrackId/{userId}/{trackId}/{trackCount}")
    Result<List<TrackInfo>> getTrackListByCurrentTrackId(@PathVariable(value = "userId") Long userId,
                                                         @PathVariable(value = "trackId") Long trackId,
                                                         @PathVariable(value = "trackCount") Integer trackCount);

    /**
     * 查询声音对象
     * @param trackId
     * @return
     */
    @GetMapping("/getTrackInfoByTrackId/{trackId}")
    Result<TrackInfo> getTrackInfoByTrackId(@PathVariable(value = "trackId") Long trackId);

    /**
     * 查询专辑对象
     * @param trackId
     * @return
     */
    @GetMapping("/getAlbumInfoByTrackId/{trackId}")
    Result<AlbumInfo> getAlbumInfoByTrackId(@PathVariable(value = "trackId") Long trackId);
}